package com.example.library.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.example.library.dto.LoginRequest;
import com.example.library.dto.RegisterRequest;
import com.example.library.dto.UserQueryRequest;
import com.example.library.entity.User;

import java.util.List;

/**
 * 用户服务接口
 *
   */
public interface UserService extends IService<User> {

    /**
     * 用户登录
     *
     * @param loginRequest 登录请求
     * @return JWT令牌
     */
    String login(LoginRequest loginRequest);

    /**
     * 用户注册
     *
     * @param registerRequest 注册请求
     * @return 用户信息
     */
    User register(RegisterRequest registerRequest);

    /**
     * 根据用户名查询用户
     *
     * @param username 用户名
     * @return 用户信息
     */
    User findByUsername(String username);

    /**
     * 根据邮箱查询用户
     *
     * @param email 邮箱
     * @return 用户信息
     */
    User findByEmail(String email);

    /**
     * 分页查询用户列表
     *
     * @param queryRequest 查询请求
     * @return 用户分页列表
     */
    IPage<User> getUserPage(UserQueryRequest queryRequest);

    /**
     * 创建用户
     *
     * @param user 用户信息
     * @return 创建结果
     */
    boolean createUser(User user);

    /**
     * 更新用户信息
     *
     * @param user 用户信息
     * @return 更新结果
     */
    boolean updateUser(User user);

    /**
     * 删除用户
     *
     * @param userId 用户ID
     * @return 删除结果
     */
    boolean deleteUser(Long userId);

    /**
     * 批量删除用户
     *
     * @param userIds 用户ID列表
     * @return 删除结果
     */
    boolean batchDeleteUsers(List<Long> userIds);

    /**
     * 启用/禁用用户
     *
     * @param userId 用户ID
     * @return 更新结果
     */
    boolean updateUserStatus(Long userId);

    /**
     * 批量更新用户状态
     *
     * @param userIds 用户ID列表
     * @param status  状态
     * @return 更新结果
     */
    boolean batchUpdateUserStatus(List<Long> userIds, Integer status);

    /**
     * 重置用户密码
     *
     * @param userId      用户ID
     * @param newPassword 新密码
     * @return 重置结果
     */
    boolean resetPassword(Long userId, String newPassword);

    /**
     * 修改密码
     *
     * @param userId      用户ID
     * @param oldPassword 旧密码
     * @param newPassword 新密码
     * @return 修改结果
     */
    boolean changePassword(Long userId, String oldPassword, String newPassword);

    /**
     * 更新用户头像
     *
     * @param userId 用户ID
     * @param avatar 头像URL
     * @return 更新结果
     */
    boolean updateAvatar(Long userId, String avatar);

    /**
     * 获取用户统计信息
     *
     * @return 统计信息
     */
    Object getUserStatistics();

    /**
     * 检查用户名是否存在
     *
     * @param username 用户名
     * @return 是否存在
     */
    boolean existsByUsername(String username);

    /**
     * 检查邮箱是否存在
     *
     * @param email 邮箱
     * @return 是否存在
     */
    boolean existsByEmail(String email);

    /**
     * 检查手机号是否存在
     *
     * @param phone 手机号
     * @return 是否存在
     */
    boolean existsByPhone(String phone);

}